________________________________________________________________________________

Microsoft CAPIMON 1.0 README
________________________________________________________________________________

CONTENTS:

1. INSTALLING ON WINDOWS 2000

2. HOW TO EDIT THE FILTER FILE

3. DELAY IN CAPIMONUI DISPLAY ON WINDOWS 2000

4. ERROR MONITORING PROCESS

5. LINKS FAIL USING CAPIMON VIEWER
________________________________________________________________________________

1. INSTALLING ON WINDOWS 2000

Microsoft CAPIMON 1.0 runs on Windows XP and the Windows Server 2003 family operating systems. CAPIMON is also supported on Windows 2000 computers running Service Pack 3 and later.

Computers running Windows 2000 must install the Windows Application Compatibility Toolkit 2.6 before installing CAPIMON.  This toolkit is available from the Microsoft Web site at: 

http://www.microsoft.com/downloads/details.aspx?FamilyID=09dac794-b803-4b92-83c9-6a9e8b801434&DisplayLang=en

In addition, Windows 2000 computers must install the Microsoft XML Parser (MSXML) 3.0 Service Pack 4 (SP4) before using the CAPIMON viewer. This software is available from the Microsoft Web site at: 

http://www.microsoft.com/downloads/details.aspx?familyid=c0f86022-2d4c-4162-8fb8-66bfc12f32b0&displaylang=en

________________________________________________________________________________

2. HOW TO EDIT THE FILTER FILE

The filter INF file is documented in both the CAPIMON documentation and in the Capimon_filter.inf file with comments. The INF is parsed and the settings are applied once, when the process starts. Filtering to log only errors is enabled by default. This means that you will not see any transactions in the log if there are no errors. 

If you want to change the filter settings before the process is started, edit capimon_filter.inf with Notepad or another plain text editor and save it.

If you want to change the filter settings while the monitored process is active, perform the following steps: 

1. Edit Capimon_filter.inf with Notepad or another plain text editor.
2. Save the file with a different file name.
3. Run capimon /start /filter:filterfilepath, where filterfilepath is the path and file name you created in step 2. 

Future transactions will pick up the new settings. 

For more information on editing the Capimon_filter.inf, see the CAPIMON documentation.

________________________________________________________________________________

3. DELAY IN CAPIMONUI DISPLAY ON WINDOWS 2000

When using the Microsoft CAPIMON 1.0 viewer on computers running Windows 2000, you may sometimes encounter a delay between clicking links in the viewer and the details of those links being displayed. This happens when the CAPIMON viewer makes one or more LDAP queries and does not get a timely response. Windows 2000 waits until the LDAP query times out before continuing to display the information. If your computer is not connected to the network or the queries cannot be serviced, this timeout will be encountered. Because these LDAP queries are part of the information being displayed, they are necessary to make. 

________________________________________________________________________________

4. ERROR MONITORING PROCESS

When you configure CAPIMON to monitor a process with Capimon.exe -setup, you may receive the following error message:

Error: Invalid pointer

This error is encountered when the user that runs the command does not have sufficient user rights to monitor the desired application. To resolve this error, log in as a member of the local administrator's group and run the command again.
________________________________________________________________________________

5. LINKS FAIL USING CAPIMON VIEWER

When using the CAPIMON viewer (Capimonui.exe) to display CAPIMON log files, you may see some links fail to display data. This can happen when you are using the viewer on Windows XP or the Windows Server 2003 family computers. This failure is caused by incompatibility between the CAPIMON viewer and the Themes functionality in Windows XP and the Windows Server 2003 family. 

To correctly view the data, you must perform the following steps:

	1. Click Start, click Run, type the name of the installation directory for Microsoft CAPIMON, and then click OK. By default, the installation directory is C:\Program Files\Microsoft CAPIMON 1.0.
	2. Right click Capimonui.exe, and then click Properties.
	3. Click Compatibility, and then select Disable visual themes. Click OK.

________________________________________________________________________________